Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Creating and Manipulating Transform Objects

GXCloneTransform

You can use the GXCloneTransform function to clone a transform object--that is, to add a reference to it and increment its owner count.

gxTransform GXCloneTransform(gxTransform source);

source

A reference to the transform object to clone.

function result

A copy of the reference to the source transform object.

DESCRIPTION

The GXCloneTransform function increments the owner count of the transform referenced by the source parameter. You typically use this function when you want to create another reference to an existing transform rather than creating a distinct copy of the transform.

This function returns as its function result a reference to the transform--the same reference you pass in as the source parameter. It also increments the transform's owner count.

ERRORS, WARNINGS, AND NOTICES

Errors
transform_is_nil

SEE ALSO

For an example of the use of this function, see Listing 6-2 on page 6-17.

Owner counts for transform objects are discussed in the section "Copying, Comparing, and Cloning Transform Objects" beginning on page 6-16, and in the section "Manipulating a Transform Object's Owner Count" beginning on page 6-19.

To examine the owner count of a transform, use the GXGetTransformOwners function, described on page 6-39. To decrement the owner count of a transform, use the GXDisposeTransform function, described on page 6-34.